home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / com_pack.zip / COMPAK.DOC < prev    next >
Text File  |  1989-03-31  |  8KB  |  225 lines
  1.                   C O M - P A C K  v 1 . 0
  2.                   """"""""""""""""""""""""
  3.                        Copr. 1989
  4.                            by
  5.                       Jack A. Orman
  6.  
  7. *  What is COM-Pack?
  8.  
  9.    This is a short utility program which will combine up to
  10.    sixteen .COM files into one central library for storage.
  11.    Programs can be run directly from the library.
  12.  
  13. *  What's the advantage?
  14.  
  15.    A file stored on a hard disk takes up a cluster of disk
  16.    space no matter how short the file may be. That means
  17.    that if you have a utility program of 7 bytes, it will
  18.    still use a full cluster! On most hard drives there is 2k
  19.    or 4k per cluster, and your 7 byte .COM file will tie up
  20.    2048 or 4096 bytes of disk space! That's 2041 or 4089
  21.    bytes of empty and wasted disk space!
  22.  
  23.    By storing a collection of short .COM files in a COM-Pack
  24.    library, you can save most of that wasted space!
  25.  
  26. *  How does it work?
  27.  
  28.    COM-Pack can be used to create an executable file with any
  29.    legal DOS filename which can combine up to 16 COM
  30.    programs and use only the disk space which is required to
  31.    hold the library program.
  32.  
  33.    Example:  The enclosed sample library called "EPRINT" is
  34.      composed of ten short COM files to set the print
  35.      functions of an Epson printer. Each of the printer
  36.      control COM programs is about 50 bytes in length;
  37.      however, when saved to a disk, each of the programs uses
  38.      a full cluster of disk space. On my hard drive this
  39.      amounts to 20480 bytes of disk space to store the 10
  40.      programs that occupy a total of 501 bytes. Only 2.44%
  41.      of the disk space is being used!
  42.  
  43.      The EPRINT library which contains all ten of the
  44.      printer programs -ready to run- is only 1286 bytes and
  45.      occupies but a single cluster of the hard drive. I've
  46.      saved 9 clusters of space, or a grand total of 18432
  47.      bytes!
  48.  
  49.      Floppies have 1024 byte clusters, but a substantial
  50.      savings is also possible when using COM-Pack with
  51.      these disks.
  52.  
  53.  
  54. *  Limitations?
  55.  
  56.    Yes, there is a limit of 16 files that can be stored in a
  57.    single COM-Pack library, and the total length of the
  58.    library must not exceed 64k, just as with any other DOS
  59.    command program. Only EXE programs can exceed 64k without
  60.    using some form of overlays.
  61.  
  62.    You can create as many COM-Pack libraries as you need,
  63.    each with a 16 file/64k limit. Obviously, if they are
  64.    stored in the same directory, they must have different
  65.    names.
  66.  
  67. *  HOW TO USE COM-Pack
  68.  
  69.  1. To create a new library.
  70.  
  71.     Execute COM-Pack as follows:
  72.  
  73.       COM-Pack parm1 parm2 <enter>
  74.  
  75.     where parm1 is the name of the library that you wish to
  76.     create. Parm1 must be a legal DOS filename with the .COM
  77.     extention.
  78.  
  79.     Parm2 is the name of an existing COM program that you
  80.     have stored on disk which you want to add to the COM-Pack
  81.     library.
  82.  
  83.     Either parm1 or parm2 (or both) may contain DOS paths or
  84.     drive designations.  NOTE: Both parm1 and parm2 will
  85.     require the .COM extention.
  86.  
  87.     When the command is executed, COM-Pack will reply:
  88.  
  89.      "Library not found!  Create it?"
  90.  
  91.     This allows you to double check the name of the file
  92.     being created. You should see this message any time you
  93.     are trying to create a new library! Merely hit the 'Y' key
  94.     to complete the creation process. Hitting 'N' will cause
  95.     the program to prompt you with:
  96.  
  97.      "Do you want to enter a new file name?"
  98.  
  99.     This allows you to change the filename that was entered
  100.     on the command line, should it be incorrect. Hit 'Y' to
  101.     continue and 'N' to abort the COM-Pack process.
  102.  
  103.  2. To add programs to an existing COM-Pack library.
  104.  
  105.     Execute COM-Pack as follows:
  106.  
  107.       COM-Pack parm1 parm2 <enter>
  108.  
  109.     where parm1 is the name of an existing library that you
  110.     wish to add files to.
  111.  
  112.     Parm2 is the name of an existing COM program that you
  113.     have stored on disk which you want to add to the COM-Pack
  114.     library.
  115.  
  116.     Both parm1 and parm2 will require the .COM extention.
  117.  
  118.     COM-Pack will load the existing library and add the new
  119.     program without disturbing the previous contents.
  120.     It also adds the name of the added file to an internal
  121.     index.
  122.  
  123.     Parm1 is the name that will be used as the filename of
  124.     the library, just as parm2 will be the name that is
  125.     stored in the library index. If you wish to have a
  126.     program stored in the library  with an alternate file
  127.     (such as a shortened one), use the DOS rename command to
  128.     change the name of the file before executing COM-Pack.
  129.  
  130.  3. To run a program from the COM-Pack created library.
  131.  
  132.     Library_name  filename  parameters  <enter>
  133.  
  134.     where Library_name is the DOS name of a previously
  135.     created COM-Pack library which contains the program
  136.     specified by 'filename'. The parameters are those which
  137.     would normally be used with the program specified by the
  138.     filename.
  139.  
  140.     Example:
  141.  
  142.       I've created a library which contains the programs,
  143.       TSRMAKER, PRNMAKER, DOCMAKER and CRT31. The name of
  144.       the library is 'AS.COM'. I want to run the program
  145.       CRT31 from the library to change border colors.
  146.  
  147.       The regular CRT31.COM program would be run by
  148.       entering:
  149.                  CRT31  BO  1  <enter>
  150.       which would change the border color to blue.
  151.  
  152.       To run the same program to set a blue border from my
  153.       COM-Pack library, I would use:
  154.  
  155.                  AS  CRT31  BO  1  <enter>
  156.  
  157.       Notice that the .COM extention is not required for the
  158.       file that is stored in the library.
  159.  
  160.  4. To see a listing of the files that are stored in a
  161.     COM-Pack library.
  162.  
  163.       Library_name -H <enter>
  164.  
  165.     This will display a list of the programs which are
  166.     stored in the library.
  167.  
  168.  5. COM-Pack does not erase or modify the orginal program
  169.     that is being added to the library; it merely copies it
  170.     into the library file.
  171.  
  172. *   Comments
  173.         I would like to hear your comments on this or any
  174.         other programs from ARMADA SOFTWARE. Suggestions of
  175.         new features, bugs that may be detected, or just
  176.         your impressions and thoughts about the program are
  177.         welcome. The author may be reached at the address
  178.         below or via:
  179.  
  180.         DELPHI at e-mail address:  JAO
  181.         GEnie at e-mail address :  J.ORMAN
  182.         Compuserve at user i.d. :  72261,677
  183.  
  184. *   Copyright Notice
  185.  
  186.         These programs and the documentation are the
  187.         copyrighted property of Jack A. Orman and are not to
  188.         be resold without express written permission. The
  189.         complete archive MAY be uploaded to a BBS or
  190.         commercial information service if all of the files
  191.         are included and are not modified in any way.
  192.  
  193. *   Shareware Notice
  194.  
  195.         COM-Pack.arc is from the ARMADA UTILITIES Disk #2 which
  196.         may be obtained by sending a $20.00 check or money
  197.         order to:
  198.                     Jack A. Orman
  199.                     ARMADA SOFTWARE
  200.                     Box 858
  201.                     Southaven, MS 38671
  202.  
  203. *   ARMADA UTILITIES Disk #2 contains:
  204.  
  205.            BOOT-C  .arc                BOOTREX .arc
  206.            COP     .arc                EKHO    .arc
  207.            EOF     .arc                NOLF    .arc
  208.            SIGNAL  .arc                LOCATE  .arc
  209.            DISKOPT .arc                PRNmaker.arc
  210.            TXTmaker.arc                MAILIT  .arc
  211.            COM-Pack .arc                and more!
  212.  
  213.  
  214. *   ARMADA UTILITIES Disk #1 available for $20.00 contains:
  215.  
  216.            ALTPAGE .arc                AUTHOR  .arc
  217.            BOOT    .arc                CASE    .arc
  218.            CASIOID .arc                CRLF    .arc
  219.            CRT31   .arc                CURSOR  .arc
  220.            DOCMAKER.arc                FRQCNV4 .arc
  221.            FXPRNT22.arc                MIDIPOP .arc
  222.            PRINTIT .arc                RB1000  .arc
  223.            TSRMAKER.arc                README
  224.            TSRHELP .DOC
  225.